home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / comm / bbs / xbj18.lha / xbj.doc < prev   
Text File  |  1993-03-06  |  6KB  |  164 lines
  1.  
  2.                       Al's Blackjack Casino
  3.  
  4.                           Version 1.7
  5.  
  6.                    (formerly Al's Xeno Casino)
  7.                   (formerly Xenolink Blackjack)
  8.  
  9.                Alan Bland               CYBERMIGA!
  10.                442 Seven Hills Drive  (303)939-9923
  11.                Boulder, CO 80302 USA    1:104/121
  12.  
  13.     Copyright (c) 1993 by Alan Bland, All Rights Reserved
  14.  
  15.     XBJ is freely distributable as long as the program is
  16.     not modified in any way, and the copyright notice when
  17.     the program starts remains intact.
  18.  
  19.  
  20. WHAT IS IT?
  21. -----------
  22.  
  23. Al's Blackjack Casino (XBJ) is a Blackjack game door for Amiga BBS
  24. systems.  It was originally written as a Xenolink-specific game, but
  25. was later changed to use the standard CLI protocol used by nearly
  26. every BBS program on the Amiga.  Al's Blackjack Casino has worked on
  27. DLG, Xenolink, Transamiga, CNet, and probably others that I have not
  28. heard about.
  29.  
  30. I currently run DLG and do all my testing with DLG, so I cannot make
  31. any guarantees that it will work with any other BBS program.
  32.  
  33. Al's Blackjack Casino plays a basic one-player Blackjack game, uses
  34. ANSI color graphics, and maintains a high-score file so your BBS users
  35. can compete against each other for the number one spot!  The high
  36. scores are reset at the beginning of every month, so it's easy to run
  37. monthly contests among your users.
  38.  
  39. Al's Blackjack Casino is freeware.  Install it on your BBS and let
  40. your users have fun.  If you like this program, I'd appreciate hearing
  41. your comments.
  42.  
  43.  
  44. UPGRADING FROM PREVIOUS VERSIONS
  45. --------------------------------
  46.  
  47. This version of Al's Blackjack Casino has many new options.  You
  48. should read this file in its entirety to determine how you want to
  49. customize the casino.  However, you need not do any customization.
  50. XBJ will choose reasonable defaults for you.  Your current user's
  51. scores will be preserved when you run this version.
  52.  
  53.  
  54. INSTALLATION FOR DLG
  55. --------------------
  56.  
  57. Create a directory named DOORS:XBJ and copy the XBJ executable file
  58. there.  Use the following menu entry:
  59.  
  60.          Executable:  doors:xbj/xbj -u "%NAME" -p %PORT
  61.         Description:  Al's Blackjack Casino
  62.                Type:  Executable
  63.           Load type:  Overlay
  64.       Pend messages:  Yes
  65.            Cli mode:  No
  66.  
  67. The %PORT option is used primarily for DLG to determine if it is
  68. running locally (TLx) or remotely (TRx).  The local DLG port has
  69. trouble displaying certain ANSI graphics, so %PORT is used to display
  70. alternate characters so that DLG sysops can conveniently play the game
  71. from the local port.  %PORT is also required if you want XJB to show
  72. DLG system messages during the game.
  73.  
  74.  
  75. INSTALLATION FOR XENOLINK Z3a
  76. -----------------------------
  77.  
  78. Create a directory named DOORS:XBJ and copy the XBJ executable file
  79. there.  Add a menu selection to invoke XBJ using the following
  80. command:
  81.  
  82.          XenolinkDoor "^8000^3^xbj/xbj"
  83.  
  84. The "3" in the command is the number of nodes allowed to run XBJ at
  85. the same time.  Set that to be the number of nodes you run on your
  86. BBS.  If you are running Xenolink Z4, you may want to run it as a
  87. standard CLI door.
  88.  
  89.  
  90. INSTALLATION FOR OTHER BBS PROGRAMS
  91. -----------------------------------
  92.  
  93. Other BBS programs should run XBJ as a standard CLI door, passing the
  94. -u parameter specifying the user's name.  The -p parameter is needed
  95. only for DLG and need not be specified for other BBS programs.  A
  96. stack size of 8000 is recommended.
  97.  
  98.  
  99. CONFIGURATION FILE
  100. ------------------
  101.  
  102. XBJ now reads a configuration file, DOORS:XBJ/XBJ.CFG.  An example
  103. configuration file is provided.  You should edit the example
  104. configuration file to customize XBJ to your needs.
  105.  
  106. The configuration file consists of keywords and values.  You may
  107. specify the keywords in any order, and you may mix upper and lower
  108. case letters.  Lines beginning with a ";" are ignored.
  109.  
  110. If you do not install the XBJ.CFG file, reasonable defaults will be
  111. used.
  112.  
  113. See the comments in the supplied XBJ.CFG file for all the possible
  114. configuration options.
  115.  
  116.  
  117. MONTHLY SCORE FILES
  118. -------------------
  119.  
  120. The user scores now get reset the first time the game is played each
  121. month.  The files listed below are maintained by XBJ in the DOORS:XBJ
  122. directory.  Normally XBJ will handle these files automatically; you
  123. should never have to do anything with them.
  124.  
  125.    xbj.users       This contains the current month's scores and other
  126.                    per-user information.  Delete this file if you want
  127.                    to reset the scores.
  128.  
  129.    xbj.users.last  This contains last month's per-user data.  It's not
  130.                    really used, but is kept around in case you need to
  131.                    restore it.
  132.  
  133.    month.file      This file controls when XBJ decides to begin a new
  134.                    month.  You only need to worry about this file if
  135.                    you manage to mess up the date on your Amiga, or if
  136.                    nobody plays XBJ for more than a month.  This file
  137.                    contains the month number (0-11) when XBJ last wrote
  138.                    the score files.  XBJ will switch to a new month
  139.                    when the current month is different from this value.
  140.                    HOWEVER, IF XBJ DETECTS THAT THE MONTH HAS SKIPPED
  141.                    BY MORE THAN A SINGLE MONTH, IT WILL DISPLAY AN
  142.                    ERROR AND WILL NOT UPDATE THE SCORES.  This protects
  143.                    you from hosing your scores if your Amiga's clock
  144.                    goes bonkers.  You can delete this file, whereupon
  145.                    XBJ will assume the current month is correct.  You
  146.                    can also edit the value in this file to fix it, but
  147.                    that's not recommended.
  148.  
  149. The high scores are also maintained as text files that you can display
  150. as bulletins.  XBJ can optionally create these files as plain ASCII,
  151. 16-color ANSI, or using DLG ANSI codes.  See the XBJ.CFG file for
  152. details.
  153.  
  154.  
  155. CARRIER LOSS AND MULTIPLE NODES
  156. -------------------------------
  157.  
  158. Just so you know, XBJ detects carrier loss and updates the user's
  159. score and daily time used.  There's no way to avoid the daily time
  160. limit, or to abort a bad gaming session without updating the score
  161. file.  The score files are locked to prevent multiple nodes from
  162. clobbering each other, so you can run as many simultaneous copies of
  163. XBJ you wish.
  164.